home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SGI Freeware 2002 November
/
SGI Freeware 2002 November - Disc 2.iso
/
dist
/
fw_hylafax.idb
/
usr
/
freeware
/
catman
/
u_man
/
cat1
/
textfmt.Z
/
textfmt
Wrap
Text File
|
2002-07-08
|
11KB
|
242 lines
TEXTFMT(1) TEXTFMT(1)
NNAAMMEE
textfmt - convert text to POSTSCRIPT for facsimile trans
mission
SSYYNNOOPPSSIISS
$${{LLIIBBEEXXEECC}}//tteexxttffmmtt [ _o_p_t_i_o_n_s ] [ _f_i_l_e_s... ]
DDEESSCCRRIIPPTTIIOONN
_t_e_x_t_f_m_t takes ASCII text and generates formatted
POSTSCRIPT suitable for facsimile transmission. It is
usually invoked as a filter program by the _s_e_n_d_f_a_x(1) pro
gram. Input files may be specified on the command line.
If none are given, then _t_e_x_t_f_m_t will read from standard
input.
By default, _t_e_x_t_f_m_t will generate an output document that
is formatted with a single vertical column of text, set in
a 10 point fixed width font, and with a simple page header
that consists of the file name, last modification date,
and the page number. Pages are generated according to the
default page dimensions (see _p_a_g_e_s_i_z_e_s(${MANNUM4_5})).
When multi-column output is requested, text is set by
default with a 7 point fixed width font.
OOPPTTIIOONNSS
Many of the options to _t_e_x_t_f_m_t have been chosen for com
patibility with the Adobe Systems' _e_n_s_c_r_i_p_t program; other
options are for features that are not provided by
_e_n_s_c_r_i_p_t.
--11 Set text in one column.
--22 Set text two columns.
--BB Suppress page headers.
--cc Clip long text lines instead of wrapping them at
page margins.
--DD Do not use ISO 8859-1 encoding in the generated
POSTSCRIPT.
--ff _f_o_n_t
Set text using the POSTSCRIPT font named _f_o_n_t.
--FF _f_o_n_t_d_i_r_(_s_)
_P_a_t_h_(_s_) to afm font files.
--GG Use a gaudy-style page header.
--mm _c_o_l_s
Set text in _c_o_l_s columns.
--MMll==_#_,rr==_#_,tt==_#_,bb==_#
Set the page margins; the default margins are: left
and right .25 inch, top .85 inch, bottom .5 inch.
--oo Draw an outline around each column of text; the
specified number defines the width of the line that
is drawn.
--pp _p_t_s Set text using fonts with _p_t_s point size.
--rr Set pages rotated by 90 degrees (in ``Landscape
mode'').
--RR Set pages unrotated (in ``Portrait mode'').
--ss _s_i_z_e
Set the output size according to the named page
size. Images are normally created with a system-
default page size (usually letter-size pages, 8.5"
by 11", for sites in North America). Alternate
page sizes are specified symbolically using either
the name or abbreviation of an entry in the _p_a_g_e_
_s_i_z_e_s(${MANNUM4_5}) database; e.g. _a_3 (ISO A3), _a_4
(ISO A4), _a_5 (ISO A5), _a_6 (ISO A6), _b_4 (ISO B4),
_n_a_-_l_e_t (North American Letter), _u_s_-_l_e_g (American
Legal), _u_s_-_l_e_d (American Ledger), _u_s_-_e_x_e (American
Executive), _j_p_-_l_e_t (Japanese Letter), and _j_p_-_l_e_g
(Japanese Legal). Comparisons are case-insensitive
and any match of a substring of the full page-size
name is sufficient; e.g. ``legal'' would match
``American Legal''.
--UU Reverse collate pages; that is the last page will
appear first in the resultant POSTSCRIPT, then the
next-to-last page, etc.
--VV _s_p_a_c_i_n_g
Set the line height; the default height is 1.2 x
point size.
CCOONNFFIIGGUURRAATTIIOONN PPAARRAAMMEETTEERRSS
_t_e_x_t_f_m_t reads configuration information from the files
$${{LLIIBBDDAATTAA}}//hhyyllaa..ccoonnff, and ~~//..hhyyllaarrcc; in that order. Con
figuration files follow the conventions described in
_h_y_l_a_f_a_x_-_c_l_i_e_n_t(1). The following configuration parameters
are recognized:
TTaagg TTyyppee DDeeffaauulltt DDeessccrriippttiioonn
Columns integer 1 number of columns in formatted output
GaudyHeaders boolean No enable/disable guady page headers
FontMap string _s_e_e _b_e_l_o_w location of ghostscript Fontmap file
FontPath string _s_e_e _b_e_l_o_w directory for font metric files
ISO8859 boolean Yes use ISO 8859-1 character encoding
LineWrap boolean Yes wrap/truncate text lines
Orientation string portrait orientation of text on page
OutlineMargin inches 0 width of outline line
PageCollation string forward collate pages in forward or reverse direction
PageHeaders boolean Yes enable/disable page headers
PageHeight float - output page height
PageMargins string _s_e_e _b_e_l_o_w margins for formatted page
PageSize string default output page size from database
PageWidth float - output page width
TabStop integer 8 inter-stop setting in characters
TextFont string Courier name of font for setting text
TextLineHeight inches - text formatting line height control
TextPointSize inches _s_e_e _b_e_l_o_w size to use in setting text
The configuration parameters are explained below. Most
parameters correspond to a command line option. Parameter
values identified above as _i_n_c_h_e_s are converted according
to the following conventions (where ``#.##'' is a decimal
number):
#.##bp big point (1in = 72bp)
#.##cc cicero (1cc = 12dd)
#.##cm centimeter
#.##dd didot point (1157dd = 1238pt)
#.##in inch
#.##mm millimeter (10mm = 1cm)
#.##pc pica (1pc = 12pt)
#.##pt point (72.27pt = 1in)
#.##sp scaled point (65536sp = 1pt)
Unit names can be upper or lower case but no white space
is permitted between the number and the unit. Values
specified with no unit are interpreted as points.
CCoolluummnnss The number of columns to set text in.
(Equivalent to the --mm option.)
FFoonnttMMaapp The directory or directories where the
ghostscript Fontmap file(s) are located;
multiple paths are seperated by a colon
(":"). The Fontmap table allows the trans
lation of the descriptive name of the font
(as used by the _T_e_x_t_F_o_n_t parameter) to the
ghostscript font filenames. Setting the
value to "" (zero length string) disables
this translation and provides functionality
with RIPs other than ghostscript.
FFoonnttPPaatthh The path where Adobe Font Metric (AFM)
files are located; by default ${FONTPATH}.
(Equivalent to the --FF option.)
GGaauuddyyHHeeaaddeerrss Control whether or not to use a gaudy-style
page header. (Equivalent to the --GG
option.)
IISSOO88885599 Control the use of ISO 8859-1 encoding in
the generated POSTSCRIPT (Equivalent to the
--DD option.)
LLiinneeWWrraapp Control whether long text lines are wrapper
or truncated at the right hand margin.
(Equivalent to the --cc option.)
OOrriieennttaattiioonn Control whether pages are oriented horizon
tally (``landscape'') or vertically (``por
trait''). (Equivalent to the --rr and --RR
options.)
OOuuttlliinneeMMaarrggiinn Control whether columns of text have a line
drawn around them and the width of the
line. Setting this parameter to 0 disables
outlines. (Equivalent to the --oo option.)
PPaaggeeCCoollllaattiioonn Control whether the output file has pages
collated in the same order as the input
file (``forward'') or in reverse order
(``reverse). (Equivalent to the --UU
option.)
PPaaggeeHHeeaaddeerrss Control whether page headers are generated.
(Equivalent to the --BB option.)
PPaaggeeHHeeiigghhtt Set the output page height in inches (in
inches).
PPaaggeeMMaarrggiinnss Set the output page dimensions. Dimensions
are specified as string of the form:
``ll==#,rr==#,tt==#,bb==#'' where ll indicates the
left margin, rr indicates the right margin,
tt indicates the top margin, bb indicates the
bottom margin, and numbers are interpreted
as _i_n_c_h_e_s. (Equvalent to the --MM option.)
PPaaggeeSSiizzee Set the output page dimensions by name.
(Equivalent to the --ss option.)
PPaaggeeWWiiddtthh Set the output page width in inches (in
inches).
TTaabbSSttoopp Set the tab stop distance; in characters.
TTeexxttFFoonntt Set the descriptive name of font to use for
setting text. (Equivalent to the --ff
option.)
TTeexxttLLiinneeHHeeiigghhtt Set the vertical text line height and spac
ing. (Equvalent to the --VV option.)
TTeexxttPPooiinnttSSiizzee Set the point size to use in setting text.
(Equvalent to the --pp option.)
NNOOTTEESS
If _t_e_x_t_f_m_t is unable to locate font metric information for
a font, then it will use a fixed-width metric that is 60%
of the text point size; this metric will almost certainly
result in incorrectly formatted POSTSCRIPT.
_t_e_x_t_f_m_t is distantly related to the _l_p_t_o_p_s program written
by Don Beebe.
FFIILLEESS
${LIBDATA}/hyla.conf system-wide configuration file
~/.hylarc per-user configuration file
${LIBDATA}/pagesizes page size database
${FONTPATH} font metric files
SSEEEE AALLSSOO
_h_y_l_a_f_a_x_-_c_l_i_e_n_t(1), _s_e_n_d_f_a_x(1), _p_a_g_e_s_i_z_e_s(${MANNUM4_5})
May 17, 1996 TEXTFMT(1)